######################################################## 
## Mod Title:   Custom mass email Mod
## Mod Version: 1.1.0
## Author:       Niels Chr. Rd Denmark < ncr@db9.dk > http://mods.db9.dk
##
## Description:  
## This is a drop-in, if you wish to make special email templates for specific usergroups, e.g. newsletters
## this is done by making a new email template (to all installed langauges) and name it 
## custom_email_XX.tpl, where XX is substituded with the usergroup name, if you witch to make custom templates
## for "all users", simply make a template with the name custom_email.tpl
## The new file mass_email.php will also allow you as admin to give some users access to
## mass email group members, you can define for eatch group who can mass email to the group
## you may select "ALL", "REG", "PRIVATE", "MOD" or "ADMIN"
## This is done in admin panel -> group management
## if PRIVATE is selected only members of this group can email the other members, admin can of couse always email any group
## Default only admin can mass email usergroups, go into groups management to change any groups mass email permissions
##
## This mod is for phpBB2 ver 2.0.x
##
##
## 
## Installation Level:  Easy 
## Installation Time:   5-10 Minutes 
##
## Files To Edit:      2 
##	admin/admin_groups.php
##	language/english/lang_admin.php
##
## Included files: 2
## 	mass_email.php
##	language/english/lang_mass_email.php
##
## History:
##	ver 0.9.0. - initial beta 
##	    0.9.1. - improved security
##	    1.0.0. - mass_email.php is now FINAL
##	    1.1.0. - now support configuration of who may mass email (config per usergroup)
##
################################################################# 
## 
## Installation Notes: 
##
## I have not included into this how-to a link to the file groupmsg.php
## this is the file you may call to send out mass PM, only usergroup
## witch you have the permission to mass PM wil be showen
## call this file from your browser
##
######################################################## 

# 
#-----[ ADD SQL ]------------------------------------------ 
# 
ALTER TABLE groups ADD group_allow_email TINYINT (2) DEFAULT "5" NOT NULL

# 
#-----[ OPEN ]------------------------------------------ 
# 
language/lang_english/lang_admin.php

# 
#-----[ FIND ]------------------------------------------ 
# 
//
// That's all Folks!

# 
#-----[ BEFORE, ADD ]------------------------------------------ 
# 
// addded to mass email mod
$lang['group_allow_email'] = 'Permissions to mass email';
$lang['group_allow_email_explain'] = 'Select which type of users have the rights to mass email this group.';

# 
#-----[ OPEN ]------------------------------------------ 
# 
admin/admin_groups.php

# 
#-----[ FIND ]------------------------------------------ 
# 
'group_moderator' => '',

# 
#-----[ AFTER, ADD ]------------------------------------------ 
# 
'group_allow_email' => AUTH_ADMIN,

# 
#-----[ FIND ]------------------------------------------ 
# 
$group_hidden = ( $group_info['group_type'] == GROUP_HIDDEN ) ? ' checked="checked"' : '';

# 
#-----[ AFTER, ADD ]------------------------------------------ 
#
$group_alllow_all = ( $group_info['group_allow_email'] == AUTH_ALL ) ? ' checked="checked"' : '';
$group_allow_reg = ( $group_info['group_allow_email'] == AUTH_REG ) ? ' checked="checked"' : '';
$group_allow_private = ( $group_info['group_allow_email'] == AUTH_ACL ) ? ' checked="checked"' : '';
$group_allow_mod = ( $group_info['group_allow_email'] == AUTH_MOD ) ? ' checked="checked"' : '';
$group_allow_admin = ( $group_info['group_allow_email'] == AUTH_ADMIN ) ? ' checked="checked"' : '';


# 
#-----[ FIND ]------------------------------------------ 
# 
'GROUP_MODERATOR' => $group_moderator, 

# 
#-----[ AFTER, ADD ]------------------------------------------ 
# 
'GROUP_ALLOW_EMAIL' => $group_info['group_allow_email'],

'L_GROUP_ALLOW_EMAIL' => $lang['group_allow_email'],
'L_GROUP_ALLOW_EMAIL_EXPLAIN' => $lang['group_allow_email_explain'],
'L_GROUP_ALL_ALLOW_EMAIL' => $lang['Forum_ALL'],
'L_GROUP_REG_ALLOW_EMAIL' => $lang['Forum_REG'],
'L_GROUP_PRIVATE_ALLOW_EMAIL' => $lang['Forum_PRIVATE'],
'L_GROUP_MOD_ALLOW_EMAIL' => $lang['Forum_MOD'],
'L_GROUP_ADMIN_ALLOW_EMAIL' => $lang['Forum_ADMIN'],

'S_GROUP_ALL_ALLOW_EMAIL_CHECKED' => $group_allow_all,
'S_GROUP_REG_ALLOW_EMAIL_CHECKED' => $group_allow_reg,
'S_GROUP_PRIVATE_ALLOW_EMAIL_CHECKED' => $group_allow_private,
'S_GROUP_MOD_ALLOW_EMAIL_CHECKED' => $group_allow_mod,
'S_GROUP_ADMIN_ALLOW_EMAIL_CHECKED' => $group_allow_admin,
'S_GROUP_ALL_ALLOW_EMAIL' => AUTH_ALL,
'S_GROUP_REG_ALLOW_EMAIL' => AUTH_REG,
'S_GROUP_PRIVATE_ALLOW_EMAIL' => AUTH_ACL,
'S_GROUP_MOD_ALLOW_EMAIL' => AUTH_MOD,
'S_GROUP_ADMIN_ALLOW_EMAIL' => AUTH_ADMIN,

# 
#-----[ FIND ]------------------------------------------ 
# 
$delete_old_moderator = isset($HTTP_POST_VARS['delete_old_moderator']) ? true : false;

# 
#-----[ AFTER, ADD ]------------------------------------------ 
# 
$group_allow_email = isset($HTTP_POST_VARS['group_allow_email']) ? intval($HTTP_POST_VARS['group_allow_email']) : AUTH_ADMIN;


# 
#-----[ FIND ]------------------------------------------ 
# 
$sql = "UPDATE " . GROUPS_TABLE . "
SET group_type =

# 
#-----[ IN-LINE FIND ]------------------------------------------ 
# 
$group_moderator

# 
#-----[ IN-LINE AFTER,ADD ]------------------------------------------ 
# 
, group_allow_email='$group_allow_email'

# 
#-----[ FIND ]------------------------------------------ 
# 
else if( $mode == 'newgroup' )
{
$sql = "INSERT INTO " . GROUPS_TABLE . " (
VALUES (

# 
#-----[ IN-LINE FIND ]------------------------------------------ 
# 
, group_moderator

# 
#-----[ IN-LINE AFTER,ADD ]------------------------------------------ 
# 
, group_allow_email

# 
#-----[ IN-LINE FIND ]------------------------------------------ 
# 
, $group_moderator

# 
#-----[ IN-LINE AFTER,ADD ]------------------------------------------ 
# 
, '$group_allow_email'


# 
#-----[ OPEN ]------------------------------------------ 
# 
template/subsilver/admin/group_edit_body.tpl

# 
#-----[ FIND ]------------------------------------------ 
# 
	{L_GROUP_HIDDEN}</td> 
</tr>

# 
#-----[ AFTER, ADD ]------------------------------------------ 
# 

<tr> 
  <td class="row1" width="38%"><span class="gen">{L_GROUP_ALLOW_EMAIL}:</span><br/>
  <span class="gensmall">{L_GROUP_ALLOW_EMAIL_EXPLAIN}</span></td>
  <td class="row2" width="62%">
	<input type="radio" name="group_allow_email" value="{S_GROUP_ALL_ALLOW_EMAIL}" {S_GROUP_ALL_ALLOW_EMAIL_CHECKED} /> {L_GROUP_ALL_ALLOW_EMAIL} &nbsp;&nbsp;
	<input type="radio" name="group_allow_email" value="{S_GROUP_REG_ALLOW_EMAIL}" {S_GROUP_REG_ALLOW_EMAIL_CHECKED} /> {L_GROUP_REG_ALLOW_EMAIL} &nbsp;&nbsp;
	<input type="radio" name="group_allow_email" value="{S_GROUP_PRIVATE_ALLOW_EMAIL}" {S_GROUP_PRIVATE_ALLOW_EMAIL_CHECKED} /> {L_GROUP_PRIVATE_ALLOW_EMAIL} &nbsp;&nbsp;
	<input type="radio" name="group_allow_email" value="{S_GROUP_MOD_ALLOW_EMAIL}" {S_GROUP_MOD_ALLOW_EMAIL_CHECKED} /> {L_GROUP_MOD_ALLOW_EMAIL} &nbsp;&nbsp;
	<input type="radio" name="group_allow_email" value="{S_GROUP_ADMIN_ALLOW_EMAIL}" {S_GROUP_ADMIN_ALLOW_EMAIL_CHECKED} /> {L_GROUP_ADMIN_ALLOW_EMAIL} 
  </td> 
</tr>

# 
#-----[ COPY ]------------------------------------------ 
# 
copy mass_email.php to mass_email.php

# 
#-----[ COPY ]------------------------------------------ 
# 
copy lang_mass_email.php to language/english/lang_mass_email.php

# EoM 
